14.8.2.10 :noweb

The :noweb header argument controls expansion of “noweb” style (see Noweb reference syntax) references in a code block. This header argument can have one of three values: yes no or tangle.

• yes All “noweb” syntax references in the body of the code block will be expanded before the block is evaluated, tangled or exported.
• no The default. No “noweb” syntax specific action is taken on evaluating code blocks, However, noweb references will still be expanded during tangling.
• tangle All “noweb” syntax references in the body of the code block will be expanded before the block is tangled, however “noweb” references will not be expanded when the block is evaluated or exported.

Noweb prefix lines

Noweb insertions are now placed behind the line prefix of the <<reference>>. This behavior is illustrated in the following example. Because the <<example>> noweb reference appears behind the SQL comment syntax, each line of the expanded noweb reference will be commented.

This code block:

     -- <<example>>

expands to:

     -- this is the
     -- multi-line body of example

Note that noweb replacement text that does not contain any newlines will not be affected by this change, so it is still possible to use inline noweb references.